home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / X11 / XNextEvent.z / XNextEvent
Encoding:
Text File  |  2002-10-03  |  9.4 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXNNNNeeeexxxxttttEEEEvvvveeeennnntttt((((3333XXXX11111111))))   XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))    XXXXNNNNeeeexxxxttttEEEEvvvveeeennnntttt((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XNextEvent, XPeekEvent, XWindowEvent, XCheckWindowEvent,
  10.           XMaskEvent, XCheckMaskEvent, XCheckTypedEvent,
  11.           XCheckTypedWindowEvent - select events by type
  12.  
  13.      SSSSYYYYNNNNTTTTAAAAXXXX
  14.           XNextEvent(_d_i_s_p_l_a_y, _e_v_e_n_t__r_e_t_u_r_n)
  15.                 Display *_d_i_s_p_l_a_y;
  16.                 XEvent *_e_v_e_n_t__r_e_t_u_r_n;
  17.  
  18.           XPeekEvent(_d_i_s_p_l_a_y, _e_v_e_n_t__r_e_t_u_r_n)
  19.                 Display *_d_i_s_p_l_a_y;
  20.                 XEvent *_e_v_e_n_t__r_e_t_u_r_n;
  21.  
  22.           XWindowEvent(_d_i_s_p_l_a_y, _w, _e_v_e_n_t__m_a_s_k, _e_v_e_n_t__r_e_t_u_r_n)
  23.                 Display *_d_i_s_p_l_a_y;
  24.                 Window _w;
  25.                 long _e_v_e_n_t__m_a_s_k;
  26.                 XEvent *_e_v_e_n_t__r_e_t_u_r_n;
  27.  
  28.           Bool XCheckWindowEvent(_d_i_s_p_l_a_y, _w, _e_v_e_n_t__m_a_s_k, _e_v_e_n_t__r_e_t_u_r_n)
  29.                 Display *_d_i_s_p_l_a_y;
  30.                 Window _w;
  31.                 long _e_v_e_n_t__m_a_s_k;
  32.                 XEvent *_e_v_e_n_t__r_e_t_u_r_n;
  33.  
  34.           XMaskEvent(_d_i_s_p_l_a_y, _e_v_e_n_t__m_a_s_k, _e_v_e_n_t__r_e_t_u_r_n)
  35.                 Display *_d_i_s_p_l_a_y;
  36.                 long _e_v_e_n_t__m_a_s_k;
  37.                 XEvent *_e_v_e_n_t__r_e_t_u_r_n;
  38.  
  39.           Bool XCheckMaskEvent(_d_i_s_p_l_a_y, _e_v_e_n_t__m_a_s_k, _e_v_e_n_t__r_e_t_u_r_n)
  40.                 Display *_d_i_s_p_l_a_y;
  41.                 long _e_v_e_n_t__m_a_s_k;
  42.                 XEvent *_e_v_e_n_t__r_e_t_u_r_n;
  43.  
  44.           Bool XCheckTypedEvent(_d_i_s_p_l_a_y, _e_v_e_n_t__t_y_p_e, _e_v_e_n_t__r_e_t_u_r_n)
  45.                 Display *_d_i_s_p_l_a_y;
  46.                 int _e_v_e_n_t__t_y_p_e;
  47.                 XEvent *_e_v_e_n_t__r_e_t_u_r_n;
  48.  
  49.           Bool XCheckTypedWindowEvent(_d_i_s_p_l_a_y, _w, _e_v_e_n_t__t_y_p_e,
  50.           _e_v_e_n_t__r_e_t_u_r_n)
  51.                 Display *_d_i_s_p_l_a_y;
  52.                 Window _w;
  53.                 int _e_v_e_n_t__t_y_p_e;
  54.                 XEvent *_e_v_e_n_t__r_e_t_u_r_n;
  55.  
  56.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  57.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  58.  
  59.           _e_v_e_n_t__m_a_s_k
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXNNNNeeeexxxxttttEEEEvvvveeeennnntttt((((3333XXXX11111111))))   XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))    XXXXNNNNeeeexxxxttttEEEEvvvveeeennnntttt((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.                     Specifies the event mask.
  75.  
  76.           _e_v_e_n_t__r_e_t_u_r_n
  77.                     Returns the matched event's associated structure.
  78.  
  79.           _e_v_e_n_t__r_e_t_u_r_n
  80.                     Returns the next event in the queue.
  81.  
  82.           _e_v_e_n_t__r_e_t_u_r_n
  83.                     Returns a copy of the matched event's associated
  84.                     structure.
  85.  
  86.           _e_v_e_n_t__t_y_p_e
  87.                     Specifies the event type to be compared.
  88.  
  89.  
  90.           _w         Specifies the window  whose event uou are
  91.                     interested in.
  92.  
  93.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  94.           The _X_N_e_x_t_E_v_e_n_t function copies the first event from the
  95.           event queue into the specified _X_E_v_e_n_t structure and then
  96.           removes it from the queue.  If the event queue is empty,
  97.           _X_N_e_x_t_E_v_e_n_t flushes the output buffer and blocks until an
  98.           event is received.
  99.  
  100.           The _X_P_e_e_k_E_v_e_n_t function returns the first event from the
  101.           event queue, but it does not remove the event from the
  102.           queue.  If the queue is empty, _X_P_e_e_k_E_v_e_n_t flushes the output
  103.           buffer and blocks until an event is received.  It then
  104.           copies the event into the client-supplied _X_E_v_e_n_t structure
  105.           without removing it from the event queue.
  106.  
  107.           The _X_W_i_n_d_o_w_E_v_e_n_t function searches the event queue for an
  108.           event that matches both the specified window and event mask.
  109.           When it finds a match, _X_W_i_n_d_o_w_E_v_e_n_t removes that event from
  110.           the queue and copies it into the specified _X_E_v_e_n_t structure.
  111.           The other events stored in the queue are not discarded.  If
  112.           a matching event is not in the queue, _X_W_i_n_d_o_w_E_v_e_n_t flushes
  113.           the output buffer and blocks until one is received.
  114.  
  115.           The _X_C_h_e_c_k_W_i_n_d_o_w_E_v_e_n_t function searches the event queue and
  116.           then the events available on the server connection for the
  117.           first event that matches the specified window and event
  118.           mask.  If it finds a match, _X_C_h_e_c_k_W_i_n_d_o_w_E_v_e_n_t removes that
  119.           event, copies it into the specified _X_E_v_e_n_t structure, and
  120.           returns _T_r_u_e.  The other events stored in the queue are not
  121.           discarded.  If the event you requested is not available,
  122.           _X_C_h_e_c_k_W_i_n_d_o_w_E_v_e_n_t returns _F_a_l_s_e, and the output buffer will
  123.           have been flushed.
  124.  
  125.           The _X_M_a_s_k_E_v_e_n_t function searches the event queue for the
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXNNNNeeeexxxxttttEEEEvvvveeeennnntttt((((3333XXXX11111111))))   XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))    XXXXNNNNeeeexxxxttttEEEEvvvveeeennnntttt((((3333XXXX11111111))))
  137.  
  138.  
  139.  
  140.           events associated with the specified mask.  When it finds a
  141.           match, _X_M_a_s_k_E_v_e_n_t removes that event and copies it into the
  142.           specified _X_E_v_e_n_t structure.  The other events stored in the
  143.           queue are not discarded.  If the event you requested is not
  144.           in the queue, _X_M_a_s_k_E_v_e_n_t flushes the output buffer and
  145.           blocks until one is received.
  146.  
  147.           The _X_C_h_e_c_k_M_a_s_k_E_v_e_n_t function searches the event queue and
  148.           then any events available on the server connection for the
  149.           first event that matches the specified mask.  If it finds a
  150.           match, _X_C_h_e_c_k_M_a_s_k_E_v_e_n_t removes that event, copies it into
  151.           the specified _X_E_v_e_n_t structure, and returns _T_r_u_e.  The other
  152.           events stored in the queue are not discarded.  If the event
  153.           you requested is not available, _X_C_h_e_c_k_M_a_s_k_E_v_e_n_t returns
  154.           _F_a_l_s_e, and the output buffer will have been flushed.
  155.  
  156.           The _X_C_h_e_c_k_T_y_p_e_d_E_v_e_n_t function searches the event queue and
  157.           then any events available on the server connection for the
  158.           first event that matches the specified type.  If it finds a
  159.           match, _X_C_h_e_c_k_T_y_p_e_d_E_v_e_n_t removes that event, copies it into
  160.           the specified _X_E_v_e_n_t structure, and returns _T_r_u_e.  The other
  161.           events in the queue are not discarded.  If the event is not
  162.           available, _X_C_h_e_c_k_T_y_p_e_d_E_v_e_n_t returns _F_a_l_s_e, and the output
  163.           buffer will have been flushed.
  164.  
  165.           The _X_C_h_e_c_k_T_y_p_e_d_W_i_n_d_o_w_E_v_e_n_t function searches the event queue
  166.           and then any events available on the server connection for
  167.           the first event that matches the specified type and window.
  168.           If it finds a match, _X_C_h_e_c_k_T_y_p_e_d_W_i_n_d_o_w_E_v_e_n_t removes the
  169.           event from the queue, copies it into the specified _X_E_v_e_n_t
  170.           structure, and returns _T_r_u_e.  The other events in the queue
  171.           are not discarded.  If the event is not available,
  172.           _X_C_h_e_c_k_T_y_p_e_d_W_i_n_d_o_w_E_v_e_n_t returns _F_a_l_s_e, and the output buffer
  173.           will have been flushed.
  174.  
  175.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  176.           XAnyEvent(3X11), XIfEvent(3X11), XPutBackEvent(3X11),
  177.           XSendEvent(3X11)
  178.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 10/3/02)
  196.  
  197.  
  198.  
  199.